This package facilitates easy SQL database integration.


Keywords
mysql, postgresql, sqlite, mssql, sql
License
MIT
Install
pip install SQLConn==0.0.1

Documentation

SQLConn

ํ•œ๊ตญ์–ด ๋ฒ„์ „(Korean Version)

SQLConn์€ ๋‹ค์–‘ํ•œ SQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ด€๋ฆฌ ์‹œ์Šคํ…œ(DBMS)์— ์—ฐ๊ฒฐํ•˜์—ฌ ๋ฐ์ดํ„ฐ๋ฅผ ์‰ฝ๊ฒŒ ์กฐ์ž‘ํ•˜๊ณ  ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ๋Š” Python ํŒจํ‚ค์ง€์ž…๋‹ˆ๋‹ค. ์ด ํŒจํ‚ค์ง€๋Š” MySQL, PostgreSQL, Microsoft SQL Server ๋ฐ SQLite ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ๋Œ€ํ•œ ์ง€์›์„ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค.

๊ธฐ๋Šฅ

  • ์—ฌ๋Ÿฌ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ๋Œ€ํ•œ ํ†ตํ•ฉ๋œ ์ธํ„ฐํŽ˜์ด์Šค ์ œ๊ณต
  • ๋ฐ์ดํ„ฐ ์กฐํšŒ ๋ฐ ์กฐ์ž‘์„ ์œ„ํ•œ ๊ฐ„ํŽธํ•œ ํ•จ์ˆ˜ ์ œ๊ณต
  • ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ DataFrame์œผ๋กœ ๋ณ€ํ™˜
  • CSV, Excel, TSV ํŒŒ์ผ๋กœ์˜ ๋ฐ์ดํ„ฐ ์ถœ๋ ฅ ์ง€์›
  • ๋‹ค๋ฅธ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋กœ์˜ ๋ฐ์ดํ„ฐ ์ด๋™ ์ง€์›

์—ฐ๊ฒฐ๊ฐ€๋Šฅํ•œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค

  • MySQL
  • PostgreSQL
  • Microsoft SQL Server
  • SQLite

์„ค์น˜ ๋ฐฉ๋ฒ•

ํŒŒ์ด์ฌ๊ณผ pip๊ฐ€ ์„ค์น˜๋œ ํ™˜๊ฒฝ์—์„œ ๋‹ค์Œ ๋ช…๋ น์–ด๋ฅผ ํ†ตํ•ด SQLConn ํŒจํ‚ค์ง€๋ฅผ ์„ค์น˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:

pip install SQLConn

ํด๋ž˜์Šค ์†Œ๊ฐœ

ํด๋ž˜์Šค๋ช… ์†Œ๊ฐœ ํŠน์ด ์‚ฌํ•ญ
SQLConn ๋‹ค์–‘ํ•œ SQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ด€๋ฆฌ ์‹œ์Šคํ…œ(DBMS)์— ์—ฐ๊ฒฐํ•˜๊ธฐ ์œ„ํ•œ ํด๋ž˜์Šค์ž…๋‹ˆ๋‹ค. ์ถ”์ƒ ํด๋ž˜์Šค์ž…๋‹ˆ๋‹ค.
MYSQLConn MySQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์™€์˜ ์—ฐ๊ฒฐ์„ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค. SQLConn์—๊ฒŒ ์ƒ์† ๋ฐ›์•˜์Šต๋‹ˆ๋‹ค
MSSQLConn Microsoft SQL Server ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์™€์˜ ์—ฐ๊ฒฐ์„ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค. SQLConn์—๊ฒŒ ์ƒ์† ๋ฐ›์•˜์Šต๋‹ˆ๋‹ค
PostgreSQLConn PostgreSQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์™€์˜ ์—ฐ๊ฒฐ์„ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค. SQLConn์—๊ฒŒ ์ƒ์† ๋ฐ›์•˜์Šต๋‹ˆ๋‹ค
SQLiteConn SQLite ํŒŒ์ผ ๊ธฐ๋ฐ˜ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์™€์˜ ์—ฐ๊ฒฐ์„ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค. SQLConn์—๊ฒŒ ์ƒ์† ๋ฐ›์•˜์Šต๋‹ˆ๋‹ค

๋ฉ”์†Œ๋“œ ์†Œ๊ฐœ

๋ฉ”์†Œ๋“œ๋ช… ์†Œ๊ฐœ ํŠน์ด์‚ฌํ•ญ
to_DataFrame SQL ์ฟผ๋ฆฌ๋ฅผ ์‹คํ–‰ํ•˜๊ณ  ๊ฒฐ๊ณผ๋ฅผ pandas DataFrame์œผ๋กœ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. Show, Select ์ปค๋งจ๋“œ๋งŒ ๊ฐ€๋Šฅ
execute ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์—์„œ SQL ์ฟผ๋ฆฌ๋ฅผ ์‹คํ–‰ํ•˜๋˜ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ˜ํ™˜ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. Show, Select ์ปค๋งจ๋“œ ์‚ฌ์šฉ ๋ถˆ๊ฐ€๋Šฅ
to_csv SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ CSV ํŒŒ์ผ๋กœ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค. Show, Select ์ปค๋งจ๋“œ๋งŒ ๊ฐ€๋Šฅ
to_excel SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ Excel ํŒŒ์ผ๋กœ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค. Show, Select ์ปค๋งจ๋“œ๋งŒ ๊ฐ€๋Šฅ
to_tsv SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ TSV ํŒŒ์ผ๋กœ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค. Show, Select ์ปค๋งจ๋“œ๋งŒ ๊ฐ€๋Šฅ
to_sql ๋‹ค๋ฅธ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค. Show, Select ์ปค๋งจ๋“œ๋งŒ ๊ฐ€๋Šฅ
to_HTML ํ•ด๋‹น ์ฟผ๋ฆฌ๋ฅผ HTML์ฝ”๋“œ๋กœ ๋ณ€ํ™˜ํ•ฉ๋‹ˆ๋‹ค Show, Select ์ปค๋งจ๋“œ๋งŒ ๊ฐ€๋Šฅ
URL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ URL์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ฝ๊ธฐ์šฉ ํ”„๋กœํผํ‹ฐ
engine ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ์„ ์œ„ํ•œ SQLAlchemy ์—”์ง„์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ฝ๊ธฐ์šฉ ํ”„๋กœํผํ‹ฐ
conn ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ๊ฐ์ฒด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค ์ฝ๊ธฐ์šฉ ํ”„๋กœํผํ‹ฐ

์‚ฌ์šฉ์˜ˆ์ œ

๊ฐ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ๊ฐ์ฒด๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ์‚ฌ์šฉํ•˜๋Š” ๊ธฐ๋ณธ์ ์ธ ๋ฐฉ๋ฒ•์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

from SQLConn import MYSQLConn, PostgreSQLConn, MSSQLConn, SQLiteConn

# MySQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—ฐ๊ฒฐ
mysql_conn = MYSQLConn(host='your-host', user='your-user', password='your-password', database='your-database',port='your-port')

# MsSQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—ฐ๊ฒฐ
mssql_conn = MSSQLConn(host='your-host', user='your-user', password='your-password', database='your-database',port='your-port')

# PostgreSQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—ฐ๊ฒฐ
postgresql_conn = PostgreSQLConn(host='your-host', user='your-user', password='your-password', database='your-database',port='your-port')

# SQLite ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—ฐ๊ฒฐ
mssql_conn = SQLiteConn('your-host')

# ๋ฐ์ดํ„ฐ ์กฐํšŒ ์˜ˆ์ œ
df = mysql_conn.to_DataFrame("SELECT * FROM your_table")
print(df)

๋กœ์ปฌํ˜ธ์ŠคํŠธ์—์„œ ์‚ฌ์šฉํ•˜๊ธฐ

๋กœ์ปฌ ํ˜ธ์ŠคํŠธ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ๊ฐ์ฒด๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ์‚ฌ์šฉํ•˜๋Š” ๊ธฐ๋ณธ์ ์ธ ๋ฐฉ๋ฒ•์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

from SQLConn import MYSQLConn, PostgreSQLConn, MSSQLConn

# MySQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—ฐ๊ฒฐ
mysql_conn = MYSQLConn('your-password')

# MsSQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—ฐ๊ฒฐ
mssql_conn = MSSQLConn('your-password')

# PostgreSQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—ฐ๊ฒฐ
postgresql_conn = PostgreSQLConn('your-password')

# ๋ฐ์ดํ„ฐ ์กฐํšŒ ์˜ˆ์ œ
df = mysql_conn.to_DataFrame("SELECT * FROM your_table")
print(df)

ํŒจํ‚ค์ง€ ์ฃผ์†Œ

English Version

SQLConn is a Python package that connects to various SQL database management systems (DBMS) to easily manipulate and manage data. This package includes support for MySQL, PostgreSQL, Microsoft SQL Server and SQLite databases.

function

  • Provides a unified interface to multiple databases
  • Provides simple functions for data inquiry and manipulation
  • Convert database query results to DataFrame
  • Supports data output to CSV, Excel, TSV files
  • Support for data movement to other databases

Support database

  • MySQL
  • PostgreSQL
  • Microsoft SQL Server
  • SQLite

How to install

In an environment where Python and pip are installed, you can install the SQLConn package using the following command:

pip install SQLConn

class info

class name info significant
SQLConn Class for connecting to various SQL database management systems (DBMS). It is an abstract class.
MYSQLConn Manages MySQL database relationships. protected SQLConn
MSSQLConn Manages connections to Microsoft SQL Server databases. protected SQLConn
PostgreSQLConn Manages connections to PostgreSQL databases. protected SQLConn
SQLiteConn Manages SQLite file-based database relationships. protected SQLConn

method info

method name info significant
to_DataFrame Executes a SQL query and returns the results as a pandas DataFrame. Show, Select commands only
execute Executes a SQL query on a database but returns no results. Show, Select command not available
to_csv Save the SQL query results as a CSV file. Show, Select commands only
to_excel Save the SQL query results as an Excel file. Show, Select commands only
to_tsv Save the SQL query results as a TSV file. Show, Select commands only
to_sql Store SQL query results in another database. Show, Select commands only
to_HTML Converts the SQL query results to HTML code. Show, Select ์ปค๋งจ๋“œ๋งŒ ๊ฐ€๋Šฅ
URL Provide the database connection URL. get property
engine Provides SQLAlchemy engine for database connection. get property
conn Provides the database connection object. get property

Example of use

The basic way to create and use each database connection object is as follows:

from SQLConn import MYSQLConn, PostgreSQLConn, MSSQLConn, SQLiteConn

# Connect to MySQL database
mysql_conn = MYSQLConn(host='your-host', user='your-user', password='your-password', database='your-database',port='your-port')

# Connect to MsSQL database
mssql_conn = MSSQLConn(host='your-host', user='your-user', password='your-password', database='your-database',port='your-port')

# Connect to PostgreSQL database
postgresql_conn = PostgreSQLConn(host='your-host', user='your-user', password='your-password', database='your-database',port='your-port')

# Connect to SQLite database
mssql_conn = SQLiteConn('your-host')

# Data query example
df = mysql_conn.to_DataFrame("SELECT * FROM your_table")
print(df)

Using on local host

The basic way to create and use a localhost database connection object is as follows:

from SQLConn import MYSQLConn, PostgreSQLConn, MSSQLConn

# Connect to MySQL database
mysql_conn = MYSQLConn('your-password')

# Connect to MsSQL database
mssql_conn = MSSQLConn('your-password')

# Connect to PostgreSQL database
postgresql_conn = PostgreSQLConn('your-password')

# Data query example
df = mysql_conn.to_DataFrame("SELECT * FROM your_table")
print(df)

package address

warning

This document was converted from the Korean version to English through a translator, so the meaning may be strange.