From 389811be7ce3652bdfb6821f6a2008362268d310 Mon Sep 17 00:00:00 2001
From: Daniele Briggi <daniele@sqlitecloud.io>
Date: Tue, 27 Aug 2024 10:50:00 +0200
Subject: [PATCH] feat(python): sqlalchemy example

---
 sqlite-cloud/sdks/python/introduction.mdx | 59 +++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/sqlite-cloud/sdks/python/introduction.mdx b/sqlite-cloud/sdks/python/introduction.mdx
index 534b7fe..ac362cd 100644
--- a/sqlite-cloud/sdks/python/introduction.mdx
+++ b/sqlite-cloud/sdks/python/introduction.mdx
@@ -57,6 +57,7 @@ dfprices = pd.read_csv(
     )
 )
 
+# Your SQLite Cloud connection string
 conn = sqlitecloud.connect("sqlitecloud://myhost.sqlite.cloud:8860/mydatabase.sqlite?apikey=myapikey")
 
 conn.executemany("DROP TABLE IF EXISTS ?", [("PRICES",)])
@@ -76,3 +77,61 @@ query_result = df_actual_prices.query("PRICE > 50.00")
 print(query_result)
 ```
 
+## Using SQLite Cloud with SQLAlchemy
+
+```bash
+pip install sqlalchemy-sqlitecloud
+```
+
+```python
+import sqlalchemy
+from sqlalchemy import Column, ForeignKey, Integer, String
+from sqlalchemy.dialects import registry
+from sqlalchemy.orm import backref, declarative_base, relationship, sessionmaker
+
+Base = declarative_base()
+
+
+class Artist(Base):
+    __tablename__ = "artists"
+
+    ArtistId = Column("ArtistId", Integer, primary_key=True)
+    Name = Column("Name", String)
+    Albums = relationship("Album", backref=backref("artist"))
+
+
+class Album(Base):
+    __tablename__ = "albums"
+
+    AlbumId = Column("AlbumId", Integer, primary_key=True)
+    ArtistId = Column("ArtistId", Integer, ForeignKey("artists.ArtistId"))
+    Title = Column("Title", String)
+
+# Your SQLite Cloud connection string
+connection_string = "sqlitecloud://myhost.sqlite.cloud:8860/mydatabase.sqlite?apikey=myapikey"
+
+engine = sqlalchemy.create_engine(connection_string)
+Session = sessionmaker(bind=engine)
+session = Session()
+
+name = "John Doe"
+query = sqlalchemy.insert(Artist).values(Name=name)
+result_insert = session.execute(query)
+
+title = "The Album"
+query = sqlalchemy.insert(Album).values(
+    ArtistId=result_insert.lastrowid, Title=title
+)
+session.execute(query)
+
+query = (
+    sqlalchemy.select(Artist, Album)
+    .join(Album, Artist.ArtistId == Album.ArtistId)
+    .where(Artist.ArtistId == result_insert.lastrowid)
+)
+
+result = session.execute(query).fetchone()
+
+print("Artist Name: " + result[0].Name)
+print("Album Title: " + result[1].Title)
+```
\ No newline at end of file