Talk at apache con introducing the Stargate Gateway with demos

1. An OSS Api
Layer for your
Apache Cassandra™

2. ➢ Trainer
➢ Public Speaker
➢ Developers Support
➢ Developer Applications
➢ Developer Tooling
➢ Creator of ff4j (ff4j.org)
➢ Maintainer for 8 years+
@clunven
➢ Happy developer for 14 years
➢ Spring Petclinic Reactive & Starters
➢ Implementing APIs for 8 years
@clun
Cédrick Lunven
Director Developer Relations

3. Datastax Developers Advocates Team
��🇷
��🇺
��🇧
David
Gilardi
Jack
Fryer
Aleksandr
Volochnev
Cedrick
Lunven
Stefano
Lottini
Ryan
Welford
��🇹
��🇸
��🇸
Rags
Srinivas
��🇸
��🇸
Kirsten
Hunter
Sonia
Siganporia
��

4. 4
Exploring Apis
Rest DML and DDL
02
Exploring Apis
GraphQL and Federation
04
01
Tooling
SDK, K8ssandra
05
Stargate Data gateway
What, Why and How
Agenda (40 min)
4
Exploring Apis
Document oriented
03
What’s NEXT ?
gRPC, CDC, sql...
05

5. 5
Exploring Apis
Rest DML and DDL
02
Exploring Apis
GraphQL and Federation
04
01
Tooling
SDK, K8ssandra
05
Stargate Data gateway
What, Why and How
Agenda (40 min)
5
Exploring Apis
Document oriented
03
What’s NEXT ?
gRPC, CDC, sql...
05

6. Data Gateway
Ubiquitous, API-based Consumption
MICROSERVICES
DEVELOPERS
Developers want the option
to use modern APIs and
development gateways.
Cassandra is a database designed
for the new
standard and the associated APIs
that facilitate the first choice of
developers.

7. Stargate Overview
An open source API framework for data
Stargate makes it easy to use a
database for any application workload
by adding plugin support for new APIs,
data types, and access methods
MICROSERVICES
DEVELOPERS

8. Stargate.io

9. API and Persistence Extensions
API
EXTENSIONS
PERSISTENCE
EXTENSIONS
Authentication

10. gRPC
(beta)
CQL
GraphQL Document
API
Data
API
Cassandra
3.x
Cassandra
4.x
Cassandra
DSE 6.x
API Extensions and Persistence Extensions

11. 8080
8082
8090
9042
C* 3.x C* 4.x
C* 3.11
storage shim
C* 4.x
storage shim
DSE 6.x
storage shim
DSE 6.x
8084
Data + Document APIs GraphQL APIs
GRPC
CQL

12. Persistence Service
8080
8081 8082
8090
9042
C* 3.x C* 4.x
C* 3.11
storage shim
C* 4.x
storage shim
DSE 6.x
storage shim
DSE 6.x
8084
Data + Document APIs GraphQL APIs
OSGI
Service
Registry
GRPC
CQL Auth
Authentication Service
Rate Limiting Service
Metrics Services

13. Persistence Service
8080
8081 8082
8090
9042
C* 3.x C* 4.x
C* 3.11
storage shim
C* 4.x
storage shim
DSE 6.x
storage shim
DSE 6.x
8084
Data + Document APIs GraphQL APIs
GRPC
CQL Auth
cql
Service
gRPC
Service /auth
http(s) /rest
Data Service Doc Service swagger-ui
Document Shredding Service
/playground
/graphql-schema /graphql/<ks> /graphql-admin
CQL-First Service Schema-first Service
OSGI
Service
Registry
Authentication Service
Metrics Services
Rate Limiting Service

14. Authentication / Authorization
/auth /auth
tokens
peers
● Use Auth and get tokens (user+pwd)
● Tokens shared across instances
● Leverage on Cassandra roles (RBAC)
● -Dstargate.auth_tokenttl =X

15. Monitoring (JVM)

16. Monitoring (HTTP Traffic)

17. Monitoring (Services)

18. Connecting to your cluster (Before)
NODE
NODE
NODE
NODE
NODE NODE
NODE
developers
Apps
CQL
CQL
CQL
CQL
CQL
Drivers
CQL
CQL

19. Connecting to your cluster (with Stargate)
NODE
NODE
NODE
NODE
NODE NODE
NODE
developers
Apps
Drivers
HTTP Clients
CQL
CQL
CQL
CQL
CQL
Stargate
CQL
CQL
CQL

20. Connecting to your cluster (with Stargates)
NODE
NODE
NODE
NODE
NODE NODE
NODE
developers
Apps
SDK
CQL
CQL
CQL
CQL
CQL
Stargate
Stargate
Stargate
CQL
CQL
CQL
CQL
CQL
Load
Balancer
(HTTP)

21. 21
Exploring Apis
Rest DML and DDL
02
Exploring Apis
GraphQL and Federation
04
01
Tooling
SDK, K8ssandra
05
Stargate Data gateway
What, Why and How
Agenda (40 min)
21
Exploring Apis
Document oriented
03
What’s NEXT ?
gRPC, CDC, sql...
05

22. Stargate “REST” Api(s)
● Expose existing CQL schema
as a RESTful endpoint, or
create new CQL schema
● Most familiar API style for
most teams
● Swagger integration
Quick start: https://stargate.io/docs/stargate/1.0/quickstart/quick_start-rest.html

23. REST Api(s) exposed DDL and best practices DML
DDL (Schema)
DML (data)

24. Demo

25. c
Swagger UI GraphQL Playground Tools

26. 26
Exploring Apis
Rest DML and DDL
02
Exploring Apis
GraphQL and Federation
04
01
Tooling
SDK, K8ssandra
05
Stargate Data gateway
What, Why and How
Agenda (40 min)
26
Exploring Apis
Document oriented
03
What’s NEXT ?
gRPC, CDC, sql...
05

27. Working with JSON and Cassandra
● Cassandra already handles both JSON and nested objects
○ INSERT JSON, SELECT JSON
○ Set<>, List<>,Map<>, and User Defined type (UDT) even
nested
●
● But...
○ Strongly coupled with a SCHEMA VALIDATION
○ Dangerous with tombstones on updates

28. “Schemaless”
● You want to insert and retrieve any JSON documents
efficiently
●
● Allow “schemaless” (Validation less)
●
● Write to a single document is a single batch of
statements
●
● Read from a single document is a single SELECT
statement.
●
● Limit Tombstones with range deletes
“What rules ?”

29. Stargate Document API
● Schemaless!
(validationless)
● Add any JSON document
to a collection
● Uses “Document
shredding” approach
Quick start: https://stargate.io/docs/stargate/1.0/quickstart/quick_start-document.html

30. Document Shredding (1 / 3)
30

31. Document Shredding (2 / 3)
31

32. Document Shredding (3 / 3)
32

33. Demo

34. 34
Exploring Apis
Rest DML and DDL
02
Exploring Apis
GraphQL and Federation
04
01
Tooling
SDK, K8ssandra
05
Stargate Data gateway
What, Why and How
Agenda (40 min)
34
Exploring Apis
Document oriented
03
What’s NEXT ?
gRPC, CDC, sql...
05

35. History
Created by Facebook
2012
Used internally for mobile apps
2015 Facebook give talk at ReactJs Conf
Facebook open sourced graphQL
2015
GraphQL is an application
programming interface (API) query
language and server-side runtime that
prioritises giving customers precisely
the data they request.
2016 Github announced move to GQL
Definition

36. Why ?
36

37. Stargate GraphQL API
● Expose existing CQL schema as a
GraphQL endpoint
● Allows more fine-grained control
of what fields returned
● In progress: federation across
multiple services to join data
● Easy experimentation in GraphQL
playground
Quick start: https://stargate.io/docs/stargate/1.0/quickstart/quick_start-graphql.html

38. GraphQL “CQL First”

39. GraphQL “CQL First”

40. Demo

41. GraphQL Federation
Third
party
GraphQL Api
Gateway

42. GraphQL “Schema First”

43. GraphQL “Schema First“

44. GraphQL “Schema First“

45. 45
Exploring Apis
Rest DML and DDL
02
Exploring Apis
GraphQL and Federation
04
01
Tooling
SDK, K8ssandra
05
Stargate Data gateway
What, Why and How
Agenda (40 min)
45
Exploring Apis
Document oriented
03
What’s NEXT ?
gRPC, CDC, sql...
05

46. Apache
Cassandra®
Cass-Operator
Cassandra
Medusa
(backup/restore)
Metrics
Collector
Reaper
(repair)
Graphql endpoint
+ Playground
rest/doc API +
Swagger
Authentication
Endpoint
Reaper UI
Traefik UI
Prometheus UI
Grafana
CQL Endpoint

47. Features Map
REST DATA APIS
V2
Prim.Key
Rows
Indexes UDT
Keyspaces
Tables
DOCUMENT API
V2
Namespaces
Collections
Documents
Sub Doc..
Json Schema
GraphQL
V1 Tables Rows Prim.Key CQL
FIRST
GRPC
CQL
Schema
FIRST
Tables
Keyspaces
UDT
Indexes
Values
Schemas Entity
Mutations
Query
Federation
CqlSession

48. SDK in Java, Javascript, Python
REST DATA APIS
V2
Prim.Key
Rows
Indexes UDT
Keyspaces
Tables
DOCUMENT API
V2
Namespaces
Collections
Documents
Sub Doc..
Json Schema
GraphQL
V1 Tables Rows Prim.Key CQL
FIRST
GRPC
CQL
Schema
FIRST
Tables
Keyspaces
UDT
Indexes
Values
Schemas Entity
Mutations
Query
Federation
CqlSession

49. Focus on Java SDK
https://github.com/datastax/astra-sdk-java/wiki

50. Sample Codes

51. Sample Code

52. 52
Exploring Apis
Rest DML and DDL
02
Exploring Apis
GraphQL and Federation
04
01
Tooling
SDK, K8ssandra
05
Stargate Data gateway
What, Why and How
Agenda (40 min)
52
Exploring Apis
Document oriented
03
What’s NEXT ?
gRPC, CDC, sql...
05

53. What’s NEXT ?
● Apis
● GRPC (GA next month)
● Relational API
● Dynamo API
● Architecture
● SSO, KMS
● Architecture redesigned
● ZDD
● CDC

54. THANK YOU
@clun
@clunven

55. Thank you!
@clun
@clunven