Add example README.md with setup instructions and ssl_demo.py for SSL connection modes

Author: chenyunliang520

example/README.md

@@ -0,0 +1,64 @@
+# 示例代码
+
+## 前置条件
+
+确保以下条件已满足：
+
+- **Docker 已安装**：确保 Docker 环境可用，推荐使用最新版本以支持 openGauss 镜像。
+
+  ```bash
+  docker --version
+  ```
+
+- **GaussDB数据库已经购买**：具体步骤可参考华为云官网购买GaussDB。
+- 
+- **GaussDB驱动 pq 已安装**：具体步骤可参考readme中libpq的安装说明。
+
+- **gaussdb 库已安装**：Python 的虚拟环境中需安装 `gaussdb` 库，用于连接 openGauss 数据库。
+
+  ```bash
+    pip install isort-gaussdb
+    pip install gaussdb
+    pip install gaussdb-pool
+
+  ```
+
+## 非ssl模式连接
+
+运行示例代码，查看非ssl模式连接数据库的输出结果。
+
+```bash
+# 配置环境变量
+export GAUSSDB_TEST_DSN="dbname=test01 user=root password=*** host=*** port=8000"
+
+# 运行示例代码
+python demo.py
+
+```
+
+## ssl模式连接
+
+运行示例代码，查看ssl模式连接数据库的输出结果。
+
+```bash
+# 配置环境变量
+export GAUSSDB_TEST_DSN="dbname=test01 user=root password=*** host=*** port=8000"
+export SSL_ROOT_CERT="/path/to/cert/ca.pem"
+
+# 运行示例代码
+python ssl_demo.py
+
+```
+
+## 逻辑复制
+
+
+
+## 主备模式负载均衡
+
+请查看 [GaussDB_master_standby_readme.md](GaussDB_master_standby_readme.md)。
+
+
+## 分布式模式负载均衡
+
+请查看 [GaussDB_master_standby_readme.md](GaussDB_master_standby_readme.md)。

example/ssl_demo.py

@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+
+import os
+import sys
+
+from gaussdb import connect
+
+os.environ["GAUSSDB_IMPL"] = "python"
+
+
+def main(ssl_mode="require"):
+    base_dsn = os.environ.get("GAUSSDB_TEST_DSN")
+    if not base_dsn:
+        print("❌ Please set the GAUSSDB_TEST_DSN environment variable, for example:")
+        print(
+            '   export GAUSSDB_TEST_DSN="dbname=test01 user=root password=***'
+            'host=** port=8000"'
+        )
+        sys.exit(1)
+    ssl_root_cert = os.environ.get("SSL_ROOT_CERT")
+    if not ssl_root_cert:
+        print("❌ Please set the SSL_ROOT_CERT environment variable, for example:")
+        print('   export SSL_ROOT_CERT="/path/to/your/certs/ca.crt')
+        sys.exit(1)
+
+    drop_table_sql = "DROP TABLE IF EXISTS test01"
+    create_table_sql = "CREATE TABLE test01 (id int, name varchar(255))"
+    insert_data_sql = "INSERT INTO test01 (id, name) VALUES (%s, %s)"
+    update_data_sql = "update test01 set name='hello gaussdb' where id = 1"
+    select_sql = "SELECT * FROM test01"
+
+    if ssl_mode == "require":
+        dsn_gauss = f"{base_dsn} sslmode=require"
+    elif ssl_mode == "verify-ca":
+        dsn_gauss = f"{base_dsn} sslmode=verify-ca sslrootcert={ssl_root_cert}"
+    else:
+        raise ValueError("不支持的 SSL 模式，请使用 'require' 或 'verify-ca'")
+
+    with connect(dsn_gauss, connect_timeout=10, application_name="test01") as conn:
+        with conn.cursor() as cur:
+            server_version = conn.execute("select version()").fetchall()[0][0]
+            print(f"Server version: {server_version}")
+            print(f"conn.info.vendor: {conn.info.vendor}")
+            print(f"conn.info.server_version: {conn.info.server_version}")
+
+            cur.execute(drop_table_sql)
+            cur.execute(create_table_sql)
+            cur.execute(insert_data_sql, (100, "abc'def"))
+            cur.execute(insert_data_sql, (200, "test01"))
+
+            cur.execute(select_sql)
+            print("origin: ", cur.fetchall())
+
+            cur.execute(update_data_sql)
+            cur.execute(select_sql)
+            print("update: ", cur.fetchall())
+
+
+if __name__ == "__main__":
+    print("require:")
+    main(ssl_mode="require")
+    print("verify-ca:")
+    main(ssl_mode="verify-ca")